//  ------------------------------------------------------------------------ //
//                                  RW-Banner                                //
//                    Copyright (c) 2006 BrInfo                              //
//                     <http://www.brinfo.com.br>                            //
//  ------------------------------------------------------------------------ //
//  This program is free software; you can redistribute it and/or modify     //
//  it under the terms of the GNU General Public License as published by     //
//  the Free Software Foundation; either version 2 of the License, or        //
//  (at your option) any later version.                                      //
//                                                                           //
//  You may not change or alter any portion of this comment or credits       //
//  of supporting developers from this source code or any supporting         //
//  source code which is considered copyrighted (c) material of the          //
//  original comment or credit authors.                                      //
//                                                                           //
//  This program is distributed in the hope that it will be useful,          //
//  but WITHOUT ANY WARRANTY; without even the implied warranty of           //
//  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the            //
//  GNU General Public License for more details.                             //
//                                                                           //
//  You should have received a copy of the GNU General Public License        //
//  along with this program; if not, write to the Free Software              //
//  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA //
// ------------------------------------------------------------------------- //
// Author: Rodrigo Pereira Lima (BrInfo - Solues Web)                      //
// Site: http://www.brinfo.com.br                                            //
// Project: RW-Banner                                                        //
// Descrio: Sistema de gerenciamento de mdias publicitrias               //
// ------------------------------------------------------------------------- //

[b] DESCRIPTION :[/b]
===============================
Le module Xoops permettant de contrler et afficher de manire alatoire des bannires, il peut tre utilis seul ou avec celui inclu par dfaut dans Xoops.

Le but de ce module est de permettre  l'administrateur d'avoir une organisation, robuste et efficace pour contrler des medias et des espaces publicitaires sur son site.

[b] CARACTRISTIQUES :[/b]
===============================
- Registre des bannires.
- Registre des catgories de bannires.
- Registre des modles des bannires.
- Registre des Tags des bannires.
- Registre des clients des bannires.
- 5 modles d'affichages des bannires. Y compris des blocs en Ajax.
- Tous les blocs sont clonable.
- Bloc pour les statistiques des clients et de vos bannires.
- Activation/dsactivation des bannires en 1 (un) clic.
- Les bannires inactives peuvent rester dans la base de donnes.
- Cration de Tags Smarty pour l'utilisation dans les thmes, modules, blocs et contenu.
- Le client peut vrifier la situation de ses bannires
- Le client peut faire des modifications dans ses bannires (si l'administrateur l'autorise)
- Envoi d'un E-mail aux clients avec les statistiques de ses bannires.
- Quelques fonctionnalits alatoires d'utilisation.
- Vous pourrez crer des ensembles de bannires intercales par groupes.
- Accepte l'affichage de plus d'une bannire dans les blocs.


DISPOSITIFS :
- Enregistrement des bannires par catgories et/ou par clients. Les catgories sont utilises en diffrenant la taille des bannires de sorte que vous puissiez crer des plusieurs modles d'affichage des bannires. Les clients sont des utilisateurs enregistrs sur le site et quand vous ajoutez une bannire.
- 5 modles de blocs clonables pour afficher les bannires dans plusieurs configurations, permettant  l'administrateur de choisir le nombre de bannires alatoires qu'il veut montrer, la catgorie  afficher, l'option pour crer une table pour l'affichage des bannires permet de choisir seulement dans combien de colonnes elles devraient tre affiches.
- Bloc de statistiques pour le client. Dans ce bloc est montr un tableau avec les statistiques principales de toutes bannires lies au client.
- Option d'activation et de dsactivation des bannires par un clic. Seules les bannires actives seront montres mais les inactives continuent d'tre enregistres dans la base de donnes, permettant de les ractiver  tout moment. 
- Au del des blocs d'affichage des bannires il est galement possible d'employer une bannire alatoire dans le thme de votre sitet ou dans n'importe quelle autre page que vous souhaitez, en ajoutant seulement <{$rw_banner}> le tag (ce dispositif exige une petite modification dans le noyau de xoops qui est explique dans les instructions d'installation ci-dessous).
- Page de statistiques pour le client. Dans la page principale du module, un tableau affiche toutes statistiques des bannires pour un client donn. De plus, sur cette page le client a l'option d'envoyer les statistiques de bannire sur son E-mail enregistr, et si l'administrateur l'autorise il pourra changer les informations concernant la bannire.- Affiche des bannires non alatoires dans le texte d'autres modules. Maintenant vous pouvez montrer vos bannires dans n'importe quel module qui accepte les bbcodes. Vous pouvez diter des bannires dans les news, articles, pages statiques, ainsi que dans le forum. (ce dispositif exige une petite modification dans le noyau de xoops qui est expliqu dans les instructions d'installation ci-dessous).

INSTALLATION :
L'installation de ce module est trs facile en suivant la procdure d'installation de tout autre module.
Pour activer la fonction pour l'affichage alatoire de bannire dans le thme de votre site, vous devez excuter une petite modification dans le noyau de xoops, plus particulirement dans le fichier header.php, situ  la racine de votre emplacement.

Pour raliser cette modification, ouvrez le fichier XOOPS_ROOT_PATH/header.php et  la fin du fichier ajoutez avant} ?>, le code ci-dessous :


To include this back, open the file XOOPS_ROOT_PATH/header.php and in the end of the file add before the } ?>, the code below:

###########################################################################################
#### Hack by rw-banner
#### Create smarty vars to show the banner in the theme of your site and in the templates
###########################################################################################
$mod = XoopsModule::getByDirname("rw_banner");
if ($mod){
  include_once (XOOPS_ROOT_PATH.'/modules/rw_banner/include/maketags.php');
}
###########################################################################################
#### End of the Hack by rw-banner
###########################################################################################

Etape 1 ralise ! Vous avez activ les TAGS SMARTY qui fonctionneront pour le module. Par l'intermdiaire de l'administration du module vous pouvez crer, diter, changer le statut et supprimer les tags. Chaque fois que vous voulez montrer votre bannire alatoire, dans le thme ou dans tout templates de module vous avez juste besoin de crer un tag pour le modle de publicit dsir et de l'insrer dans le fichier theme.html ou dans le template.

Pour activer cette nouvelle fonctionnalits d'affichage, vous avez besoin de modifier le noyau de xoops et particulirement le fichier XOOPS_ROOT_PATH/class/module.textsanitizer.php file.
Pour ajouter la modification, vous devez ouvrir le fichier XOOPS_ROOT_PATH/class/module.textsanitizer.php  et regarder l'appel  la fonction xoopsCodeDecode, et  la fin de celle-ci ajouter le code suivant :

#######################################################################################
#### Hack by rw-banner
#### Allow the exhibition of random banners an any module with bbcodes
#######################################################################################
$mod = XoopsModule::getByDirname("rw_banner");
if ($mod){
  include(XOOPS_ROOT_PATH.'/modules/rw_banner/include/bbcode.php');
}
#######################################################################################
#### end of the Hack by rw-banner
#######################################################################################



Pour faire ceci aisment, vous trouverez dans le dossier docs du module, les fichiers modifis que vous avez besoin pour le noyau de xoop (ne pas oublier de sauvegarder les fichiers modifis ou de les renommer en mettant un .bak  la fin de ceux-ci.

Aprs application du hack, vous aurez besoin de crer les tags dont vous avez besoin dans l'administration du module.

Regardez l'exemple ci-dessous :

Exemples :
imaginons que vous avez dj cr un tag "publicidade" et l'avez paramtr dans l'administration. Pour afficher les bannires de ce tags sur votre site, vous devriez ajouter ceci :

<{$publicidade}>

Mais dans le corps de vos articles ou de n'importe quel module de gestion de contenu qui accepte les bbcodes vous devez ajouter le tag comme suit :

[RW align=center]publicidade[/RW]


Le paramtre d'alignement accepte les valeurs "left" pour l'alignement gauche, "right" pour la droite et "center" pour le central.


///////// Fin de la traduction franaise ////////



UPDATES:
The modules had structural changes in relation to the database in relation to the previous verions. If you use any versions prior to 1.3RC we recommend you to unistall the module before installing the new version. 
In case you have a version newer than the 1.3RC, delete the rw_banner folder and replace it by the folder from the new version. Login as administrator to your site. If you use the hack in header.php file, comment it first. Access via browser the URL "XOOPS_URL/modules/rw_banner/admin/upgrade.php" and the script will update the tables automatically without loosing all the setup you have already defined and all the registered banners. Follow the steps described in the script and your module will be updated.

KNOWN BUGS:
-Banners in HTML code don't have their click counted. This bug is originally from the original xoops banner module. This function is used in our module but with some changes. 

THANKS:
I thank all my friends from the XoopsTotal community that helped me with ideas and suggestions for the development of this module, in special to my great friend Wilson and Giba (board of XT) for their great help with their ideias and help in testing the module. 

For further information or problem solving for this module access the following site: http://rwbanner.brinfo.com.br

[b]ITS DISPOSAL:[/b]
===============================
We will be inside of the possible always creating examples of as to use rw_banner and thus you will be able to get the biggest possible advantage to use this module.

If you will be using this module, does not leave to visit our site of development to suggest new features.

It also uses to advantage to fill our book of satisfied users and to order its message so that other users whom to desire to use this module can know that it functions and also he is very useful.

Rw_banner Team Leader.

[b]TheRpLima[/b]
